原帖 ｜ Jason ｜ 2026-06-17 12:15 ｜ 👍3 ｜ 阅读约1
之前泄露的 Claude Code CLI 源码，被国内很多研发团队深度研读，是普通人吃透 Agent 运行逻辑最好的学习入口。我最近也在拆解这个最优秀的 harness 源码，有很多感悟。
想要真正用好 Claude Code，不能只会输入指令调用，读懂底层 harness 运行框架源码才是核心。
整理 9 条入门核心拆解问题，顺着这条主线就能完整吃透整套 Harness 基础运行逻辑，适合零基础小白按顺序研读源码：
1. harness 的核心模块有哪些？各自承担什么职责？
2. 各个模块之间如何传递数据、联动协作？
3. CLI 命令行程序是如何启动 Claude Code Agent 主智能体的？
4. 框架内置 Tools 工具的注册流程是什么？模型输出工具调用后完整执行链路？
5. Hook 钩子机制底层原理是什么？框架默认提供哪些Hook？分别在会话/工具的哪些节点自动触发？
6. 系统提示词是固定文本还是运行时动态拼装？分层处理逻辑是什么？
7. Session 会话如何创建、存储、销毁？完整生命周期包含哪些阶段？
8. 对话上下文达到什么条件会触发自动压缩？压缩采用什么摘要策略？如何保障需求、代码、报错等关键信息不丢失？
9. Subagent 子智能体、Agent Teams 智能体团队分别是什么机制？适用场景有什么区别？父子/多智能体之间如何通信、传递任务与数据？
进阶深挖：吃透工业级 Agent 必备底层机制
仅掌握基础运行流程不够，生产环境稳定运行的核心能力集中在以下6个底层模块：
1. 权限与沙箱安全机制：多层操作拦截、文件/Shell/网络隔离逻辑，危险指令防护方案
2. Skill 技能按需加载体系：grill-me/TDD等官方技能动态注入上下文的完整流程
3. REPL交互与斜杠指令系统： /xxx 指令解析、项目配置CLAUDE.md加载逻辑
4. 大模型API通信容错：流式响应、限流重试、预算/最大轮次熔断限制
5. 插件扩展架构：第三方自定义工具、MCP外部服务接入规范
6. 全局状态与异常恢复：工具报错分级处理、会话终止后资源回收逻辑
搞懂这些，你才能把 claude code 榨干，用出最好的效果！
相关笔记